DWStrList

DWStrListimplements an indexed singly-linked list for the DWSTRING (Unicode dynamic string) data type.

Usage examples

Using the dotted syntax:

' // Build the linked list
DIM List AS DWStrList
List.Add("Result 1")
List.Add("Result 2")
List.Add("Result 3")
List.Insert(1, "New string")
List.Replace(2, "Replaced string")

' // Retrieve and print the results
FOR i AS LONG = 1 TO List.Count
   PRINT List.Item(i)
NEXT

Using NEW and the pointer syntax:

' // Build the linked list
DIM List AS DWStrList PTR = NEW DWStrList
List->Add("Result 1")
List->Add("Result 2")
List->Add("Result 3")
List->Insert(1, "New string")
List->Replace(2, "Replaced string")

' // Retrieve and print the results
FOR i AS LONG = 1 TO List->Count
   PRINT List->Item(i)
NEXT

' // Delete the list
Delete List

Methods

Name	Description
Add	Appends an item to the list.
Clear	Empties the entire list.
Count	Returns the number of items in the list.
Insert	Inserts an item at the specific index.
Item	Retrieves the item at the specified index.
Remove	Removes the specified item from the list.

DVarList

DVarListimplements an indexed singly-linked list for the DVARIANT (dynamic variant) data type. A DVARIANT can contain any kind of data except fixed-length string data (if you pass it as the input it will be converted to a unicode dynamic string).

Usage examples

Using the dotted syntax:

' // Build the linked list
DIM List AS DVarList
List.Add("Result 1")
List.Add("Result 2")
List.Add("Result 3")
List.Insert(1, "New string")
List.Replace(2, "Replaced string")

' // Retrieve and print the results
FOR i AS LONG = 1 TO List.Count
   PRINT List.Item(i)
NEXT

Using NEW and the pointer syntax:

' // Build the linked list
DIM List AS DVarList PTR = NEW DVarList
List->Add("Result 1")
List->Add("Result 2")
List->Add("Result 3")
List->Insert(1, "New string")
List->Replace(2, "Replaced string")

' // Retrieve and print the results
FOR i AS LONG = 1 TO List->Count
   PRINT List->Item(i)
NEXT

' // Delete the list
Delete List

Methods

Name	Description
Add	Appends an item to the list.
Clear	Empties the entire list.
Count	Returns the number of items in the list.
Insert	Inserts an item at the specific index.
Item	Retrieves the item at the specified index.
Remove	Removes the specified item from the list.

Add (DWStrList)

Appends a string to the list.

FUNCTION Add (BYREF dws AS DWSTRING) AS LONG

Parameter	Description
dws	The string to append.

Return value

Returns the number of items in the list.

Clear (DWStrList)

Empties the entire list.

SUB Clear

Count (DWStrList)

Returns the number of items in the list.

FUNCTION Count () AS LONG

Return value

Returns the number of items in the list.

Insert (DWStrList)

Inserts an item at the specific index.

FUNCTION Insert (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index where to insert the item.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.

Item (DWStrList)

Retrieves the item at the specified index.

FUNCTION Item (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index of the item to retrieve.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.

Remove (DWStrList)

Removes the specified item from the list. Indexes are one-based.

FUNCTION Remove (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index of the item to remove.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.

Add (DVarList)

Appends a VARIANT to the list.

FUNCTION Add (BYREF dv AS DVARIANT) AS LONG

Parameter	Description
dv	The VARIANT to append.

Return value

Returns the number of items in the list.

Clear (DVarList)

Empties the entire list.

SUB Clear

Count (DVarList)

Returns the number of items in the list.

FUNCTION Count () AS LONG

Return value

Returns the number of items in the list.

Insert (DVarList)

Inserts an item at the specific index.

FUNCTION Insert (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index where to insert the item.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.

Item (DVarList)

Retrieves the item at the specified index.

FUNCTION Item (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index of the item to retrieve.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.

Remove (DVarList)

Removes the specified item from the list. Indexes are one-based.

FUNCTION Remove (BYVAL idx AS LONG) AS BOOLEAN

Parameter	Description
idx	The one-based index of the item to remove.

Return value

If the method succeeds, it returns TRUE; otherwise, FALSE.